home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / 4sq17.zip / 4SQUARE.DOC < prev    next >
Text File  |  1992-08-27  |  14KB  |  287 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                 4  S Q U A R E
  7.                                 --------------
  8.                                      v1.7
  9.  
  10.         One of the MicroNet Collection of multi-BBS Doorware programs.
  11.             Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire
  12.           UltraBBS, Telegard, TriTel, TriBBS, Remote Access, and WWIV
  13.  
  14.                                       By
  15.  
  16.                                   Ted Freeman
  17.                                 Rt. 1, Box 869
  18.                               Tazewell, TN 37879
  19.  
  20.                            (c) Copyright 1991 - 1992
  21.                               All Rights Reserved
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                CONTENTS
  30.                                ========
  31.                                                                              
  32.       Information:      ~Copyright~
  33.                            ~Warranty~
  34.                               ~Distribution~
  35.                                  ~Registration~
  36.                                                                              
  37.       Door Operation:   ~Configuration Files~
  38.                            ~Environment Variables~
  39.                               ~Batch File~
  40.                                  ~Top Ten Bulletin~
  41.                                     ~Sysop Keys~
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                          ^Configuration Files^
  49.                           -------------------
  50.                                                                              
  51.                                                                              
  52.    Use the left/right arrows keys to select the desired system file
  53.    then press ENTER.
  54.  
  55.  
  56.  
  57.                 ~CALLINFO.BBS~
  58.                    ~CHAIN.TXT~
  59.                       ~DOOR.SYS~
  60.                          ~DORINFOx.DEF~
  61.                             ~GTUSER.BBS~
  62.                                ~PCBOARD.SYS~
  63.                                   ~SFDOORS.DAT~
  64.                                     ~TRIBBS.SYS~
  65.                                         ~USERS.SYS~
  66.                                            ~USERINFO.DAT~
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73. #
  74.  
  75. Example configuration file for|PCBOARD.SYS|
  76. ------------------------------------------
  77.                                                                              .
  78. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  79. MicroNet            <=-  (Change this to your BBS name)
  80. Ted                 <=-  (The Sysop's first name)
  81. Freeman             <=-  (The Sysop's last name)
  82.  
  83. Example configuration file for|USERS.SYS|
  84. ------------------------------------------
  85.                                                                              .
  86. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  87. MicroNet            <=-  (Change this to your BBS name)
  88. Ted                 <=-  (The Sysop's first name)
  89. Freeman             <=-  (The Sysop's last name)
  90.  
  91. Example configuration file for|DOOR.SYS|
  92. ---------------------------------------
  93.                                                                              .
  94. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  95. MicroNet PCBoard    <=-  (Change this to your BBS name)
  96. Ted                 <=-  (The Sysop's first name)
  97. Freeman             <=-  (The Sysop's last name)
  98.  
  99. Example configuration file for|USERINFO.DAT|
  100. -------------------------------------------
  101.                                                                              .
  102. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  103. MicroNet PCBoard    <=-  (Change this to your BBS name)
  104. Ted                 <=-  (The Sysop's first name)
  105. Freeman             <=-  (The Sysop's last name)
  106. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  107.  
  108. Example configuration file for|CALLINFO.BBS|
  109. -------------------------------------------
  110.                                                                              .
  111. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  112. MicroNet            <=-  (Change this to your BBS name)
  113. Ted                 <=-  (The Sysop's first name)
  114. Freeman             <=-  (The Sysop's last name)
  115.  
  116. Example configuration file for|DORINFOx.DEF|
  117. -------------------------------------------
  118.                                                                              .
  119. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  120.                           where 'x' is the BBS Node number.
  121. MicroNet            <=-  (Change this to your BBS name)
  122. Ted                 <=-  (The Sysop's first name)
  123. Freeman             <=-  (The Sysop's last name)
  124.  
  125. Example configuration file for|SFDOORS.DAT|
  126. ------------------------------------------
  127.                                                                              .
  128. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  129. MicroNet            <=-  (Change this to your BBS name)
  130. Ted                 <=-  (The Sysop's first name)
  131. Freeman             <=-  (The Sysop's last name)
  132.  
  133. Example configuration file for|CHAIN.TXT|
  134. ----------------------------------------
  135.                                                                              .
  136. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  137. MicroNet            <=-  (Change this to your BBS name)
  138. Ted                 <=-  (The Sysop's first name)
  139. Freeman             <=-  (The Sysop's last name)
  140.  
  141. Example configuration file for|GTUSER.BBS|
  142. ----------------------------------------
  143.                                                                              .
  144. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  145. MicroNet            <=-  (Change this to your BBS name)
  146. Ted                 <=-  (The Sysop's first name)
  147. Freeman             <=-  (The Sysop's last name)
  148. 1                   <=-  (COM port number - defaults to 1)
  149. 1                   <=-  (Node number - defaults to 1)
  150.  
  151. Example configuration file for|TRIBBS.SYS|
  152. ----------------------------------------
  153.                                                                              .
  154. C:\BBS\TRIBBS.BBS   <=-  (Full pathname of your TRIBBS.SYS file)
  155. MicroNet            <=-  (Change this to your BBS name)
  156. Ted                 <=-  (The Sysop's first name)
  157. Freeman             <=-  (The Sysop's last name)
  158.  
  159. Example|Batch File|
  160. -------------------
  161. A sample batch file is included and is similar to the following:
  162.                                                                              .
  163.    ECHO OFF
  164.    CD\DOORS\4SQUARE        <=- Switch to the door's Directory.
  165.    4SQUARE 4SQUARE.CNF     <=- Execute the door program and pass the
  166.                                 configuration filename to the program.
  167.    CD\PCB                  <=- Go back to PCB DIR when user exits door.
  168.    BOARD                   <=- Restart BBS.
  169.                                                                              .
  170. This Door is multi-node  compatible so you may run more than 1 node from
  171. the same .CNF file  provided the path to your system file (DORINFOx.DEF,
  172. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  173. variables, (q.v.)
  174.                                                                              .
  175. The file BRT71EFR.EXE must be accessible via the DOS PATH.
  176.  
  177.                             |Environment Variables|
  178. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  179. variables. Non-PCBoard systems may also use these variables by including
  180. the following in either your BBS batch or AUTOEXEC.BAT
  181.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  182.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  183. Then in your Door .CNF file instead of putting C:\BBSDIR\DOOR.SYS, you
  184. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  185. .CNF file for multi-node operation!
  186.                                                                              .
  187. To specify a non-standard IRQ, put the IRQ number after the .CNF on the
  188. command line.  For example:
  189.                                                                              .
  190.      4SQUARE 4SQUARE.CNF /5
  191. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  192.      4SQUARE 4SQUARE.CNF /%IRQ%  
  193.                                                                              .
  194. This tells the program to use IRQ 5 instead of the standard IRQ.
  195.  
  196.  
  197.                           |Top Ten Bulletin|
  198.                            ----------------
  199.                                                                              .
  200. The first time you run  4 SQUARE  online it  will create 3  files called
  201. 4SQUARE.BUL,  4SQUARE.BLT and  4SQUAREG.BLT.  If you wish to  change the
  202. path or filename of the Bulletin you must edit  4SQUARE.BUL & change the
  203. first line to whatever path/filename you desire.
  204.  
  205.  
  206.                              |Sysop Keys|
  207.                               ----------
  208. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  209.          written to DOOR.SYS and USERS.SYS
  210. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  211.          and/or written to DOOR.SYS and USERS.SYS
  212. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  213. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  214.          and/or written to DOOR.SYS and USERS.SYS
  215. F8    -  Returns the caller involuntarily to the BBS.
  216. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  217.          and/or written to DOOR.SYS and USERS.SYS
  218. F10   -  Activates SysOp CHAT mode within the DOOR.
  219. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  220. UP    -  Give the caller extra time while in the DOOR.  
  221. DN    -  Subtract time from the caller while in the DOOR. 
  222. HOME  -  HELP key for Status Line options.
  223. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  224. ALT-X -  PCBoard will exit after current caller logs off. Value is
  225.          passed to PCBoard. Not available on non-PCBoard systems.
  226.  
  227.                             |Distribution|
  228.                              ------------
  229.                                                                              .
  230. This program is being distributed via the SHAREWARE concept and as such,
  231. may be copied freely with the following restrictions:
  232.                                                                              .
  233.         * The program must be supplied in it's original unmodified
  234.           form, including documentation.
  235.                                                                              .
  236.         * This program may not be distributed as part of any commercial
  237.           application or service without the express, written consent
  238.           of the author.
  239.                                                                              .
  240.         * Vendors of Shareware/Public Domain software may not
  241.           distribute this program without the express, written
  242.           consent of the author, unless Vendor has been approved
  243.           by the Association of Shareware Professionals (ASP).
  244.  
  245.  
  246.                             |Registration|
  247.                              ------------
  248.                                                                              .
  249. This door represents  many hours of  programming and the author deserves
  250. just compensation for his time, efforts and expertise.  If you find this
  251. program to be of some  value and you  continue to use it on your system,
  252. you must return the order form provided along with the registration fee.
  253. Registration  entitles you to  free upgrades via  modem from  MicroNet's
  254. Support Conference.  Payments should be  made in the  form of a check or
  255. money order. Foreign orders  must be in U.S. funds drawn on a U.S. bank. 
  256.     Online registration with Visa or Mastercard is available via our
  257.     Credit Card Door on the following systems:
  258.                                                                              .
  259.       MicroNet: (615) 626-1620 ULTRA   Livewire: (609) 235-5297 MNP5
  260.         (TN)                             (NJ)    (609) 866-2551 HST DS
  261.                                                  (609) 727-3246 MNP5
  262.                                                                              .
  263. NOTE: If you register online, your registration number will be posted in
  264.       a private  message on  the system  you registered  with.  When you
  265.       register by mail, your number will be posted on MicroNet.
  266.  
  267.                               |Copyright|
  268.                                ---------
  269.                                                                              .
  270. 4 Square,  Copyright (c)1990-92 by Ted Freeman, is being  distributed as
  271. Shareware.  Under this concept you may use the  SHAREWARE (unregistered)
  272. version for a reasonable period of  time for evaluation  after which you
  273. must either register your copy or discontinue  usage.
  274.  
  275.                               |Warranty|
  276.                                --------
  277.                                                                              .
  278. This product is provided as is without warranty of any kind.  The entire
  279. risk as to the results and performance of the program is assumed by you.
  280. Futhermore, the  author does not warrant, guarantee, or  make any  other
  281. representations regarding the use of,  or the  results of the use of the
  282. program,  and you rely on the  program and  results  solely at  your own
  283. risk.  The author  cannot and will not accept  responsibility for system
  284. damage, loss of profit or any other special, consequential or incidental 
  285. damages  resulting  from  the use of or inability to  use this  product.
  286.  
  287.